Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / treeview.arc / TV.DOC < prev next >

Wrap

Text File | 1990-11-28 | 96.3 KB | 2,601 lines

Treeview (TM) A Hard Disk and File Maintenance Utility Version 1.0 USERS' MANUAL Magee Enterprises Inc. Post Office Box 1587 Norcross GA 30091 USA 404 446-6611 404 446-6650 BBS TREEVIEW(TM), A HARD DISK FILE MAINTENANCE UTILITY ISBN 0-938167-01-4 (C) Copyright 1988 Magee Enterprises, Inc. All rights reserved worldwide. A product of the United States of America. Treeview(TM) is a trademark of Magee Enterprises, Inc. All trademarks referenced within this document are the property of their respective owners. MAGEE ENTERPRISES, INC. POST OFFICE BOX 1587 NORCROSS, GEORGIA 30091 USA Sales 404-446-6611 9 AM - 5 PM Eastern Time 800-662-4330 Orders Only 404-368-0719 FAX Technical Support 404-662-5387 Voice 9 AM - 5 PM Eastern Time 404-446-6650 BBS (24 Hours/7 Days) 76004,1541 or 70167,2200 CompuServe Documentation by Mark Strelecki, Swati Mahajan, Randal DePriest and Marshall Magee. This manual was developed using WordPerfect 5.0. November 1988 Release TABLE OF CONTENTS Section Title License Agreement 1 Introduction 1-1 Features of Treeview 1-2 Documentation Conventions 2 Installation 2-1 System Requirements 2-2 Installing Treeview 3 Getting Started 3-1 Command Line Parameters 3-2 Menu Bar 3-3 The Header Area 3-4 The File Name Area 3-5 The Status Line 4 Important Keys Within Treeview 4-1 Alternate Key Usage 4-2 Control Key Usage 4-3 Function Key Usage 4-4 The Escape Key 4-5 Other Important Keys 4-6 The Mouse 4-6.1 Mice - Generally Speaking 4-6.2 Executing Files With the Mouse 4-6.3 Tagging Files With the Mouse 4-6.4 Scrolling Around With the Mouse 4-6.5 Viewing Files With the Mouse 4-6.6 Dragging the Mouse 5 Elements of Treeview 5-1 The Directory Tree 5-2 Extra File Information 5-2.1 File Sorting 5-3 File Selection Attributes 5-4 Find File Name 5-5 Show-All and Show-Sub Modes 5-6 Subdirectories 5-7 Terminate and Stay Resident Utilities 5-8 Update Target Directory TABLE OF CONTENTS Section Title 5-9 Window Commands 5-10 Interrupting Tagged File Operations 5-11 Editing Responses 5-12 External Functions of Treeview 5-13 File Oriented Operations 5-13.1 Copying Files 5-13.2 Renaming and Moving Files 5-13.3 Viewing Files 5-13.4 Editing Files 5-13.5 Resetting File Date and Time 6 Customizing Treeview 6-1 Screen Colors 6-2 DOS Command Macros 6-3 Setting File Limits 6-4 Point-and-Go 6-5 User Defined Keys 6-6 Using EMS Memory 6-7 Video Snow Checking 6-8 Defining the Editor and Viewer 6-9 DOS Volume Labels 7 Shareware Considerations 7-1 What is Shareware? 7-2 How to Register APPENDIX A Treeview Menu Structure APPENDIX B Treeview Help Structure APPENDIX C Treeview Keystroke Commands APPENDIX D DOS Command Macros APPENDIX E Customer Support Information Order Form and User Comment Form LICENSE AGREEMENT The Treeview(tm) Product is NOT "Public Domain" and it is NOT "Freeware". Treeview is a copyrighted software product developed and owned by Magee Enterprises, Inc. located in Norcross, Georgia, U. S. A. Magee Enterprises, Inc. grants you without charge the right to reproduce, distribute and use copies of this version of our Treeview shareware software product, subject to the limitations specified below, and on the express condition that you do not receive any payment, commercial benefit, or other consideration for such reproduction or distribution, or change this license agreement or the following copyright notice which appears in the software, documentation, user interface, menus and magnetic media: (C) Copyright 1988 Magee Enterprises, Inc. All rights reserved worldwide. Limitations: You may make and keep one (1)back-up copy of the software for your personal use, provided that (i) you copy all the copyright, trademark, and other information indicated on the initial screen display (or on the diskette label, for the registered version disk) onto your backup diskette label, and (ii) you have registered. Also you may distribute copies to other persons, but solely for their evaluation (i.e., to decide whether to continue using the product and therefore register) and solely for evaluation by such other persons during that thirty (30) day period. Treeview must NOT be sold or otherwise provided as part of a larger system, or as a part of a more inclusive product or service, without express written consent and licensing from Magee Enterprises, Inc. The rights to receive any such financial or other benefit, and to modify the product or employ its components in any kind of derivative work, are reserved exclusively by Magee Enterprises, Inc. Support from users enables us to develop additional features and future versions of the Treeview product. Registered users benefit from enhanced technical support, notice of new products, and bulletin board access. Contact us at: Magee Enterprises, Inc. Post Office Box 1587 Norcross, Georgia 30091 USA 404-446-6611 Also, please feel free to contribute your ideas regarding desired additional product features and functionality. THIS PRODUCT IS LICENSED "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, PERFORMANCE, OR OTHERWISE; ALL WARRANTIES ARE EXPRESSLY DISCLAIMED. BY USING THE TREEVIEW PRODUCT, YOU AGREE THAT NEITHER MAGEE ENTERPRISES, INC. NOR ANY OFFICERS, DIRECTORS, EMPLOYEES, SHAREHOLDERS, AFFILIATES, OWNERS, OR OTHER RELATED PARTIES WILL BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE) OR PERFORMANCE OF THIS PRODUCT, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT, TORT OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE. (SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE FOREGOING LIMITATION MAY NOT APPLY TO YOU.) You may not reverse-engineer, disassemble, modify, decompile or create derivative works of the product. You acknowledge that the product includes certain trade secrets and confidential information, all of which is the copyrighted intellectual property of Magee Enterprises, Inc. Treeview is a trademark of Magee Enterprises Inc. and the Magee Enterprises logo is a trademark of Magee Enterprises, Inc. All rights are reserved worldwide. IBM, PS/2 and Personal System/2 are registered trademarks of IBM Corporation. RESTRICTED RIGHTS LEGEND Use, duplication or disclosure by the Government is subject to restrictions as set forth in sub paragraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause of DFARS 252.227-7013. Magee Enterprises, Inc., Post Office Box 1587, Norcross, Georgia 30091 USA. SECTION 1 INTRODUCTION Thank you for your interest in Treeview! Treeview(TM) is a hard disk and file maintenance utility for IBM (TM) Personal Computers, Personal System/2 (TM), and other PC compatible computers. Treeview gives you simple, straightforward commands to accomplish everyday operations such as copying files, renaming or erasing files, backing up files, and much more. Treeview removes the guesswork from file maintenance tasks by displaying the files on your disk in a tabular format that is continually updated in response to your changes. Treeview speeds up time consuming disk cleanup and maintenance sessions. Treeview is a powerful hard disk and file maintenance utility system. It gives you the ability to execute DOS commands, but it does not pretend to be a full featured DOS shell that simplifies (and sometimes hinders) all DOS functions. Treeview is NOT a memory resident program that can be called up via "hot" keys. Both of these constraints were designed into Treeview to keep it as direct and unencumbering as possible. You'll find that Treeview is most useful on computer systems that have a hard disk for data storage. Treeview works just fine on floppy disk based systems, but the file maintenance needs of floppy only systems are not as great as hard disk systems. Few people have multiple directories and hundreds or thousands of files on floppy disk systems. This document describes the installation and usage of Treeview version 1.0. The document describes many features and functions of the program. Once you begin using Treeview, you'll discover more about how it works from the on-line help facility and by experimenting with the various commands. 1-1 Features of Treeview In addition to the standard file and disk maintenance functions (copy, rename, erase, etc.), Treeview has many other useful features including: * Supports from 1 to 6 windows allowing as many as 6 disks (or directories) to be displayed at the same time. * A directory tree display that shows your disk's directory structure in an easy-to-understand graphical layout. * A "Show-All" and "Show-Sub" display function that allow all files on the current disk or under the current directory to be accessed as if they were in one directory. * A File viewing function that displays files as ascii text or in hexadecimal format, and permits the use of any listing or editing program at the user's option. * A full screen interface with user selectable colors. * On-line menu-driven help available whenever Treeview is waiting for user input. * DOS Command Line Macros that give the user the ability to access complete file and pathnames by using just one or two characters * Full mouse support 1-2 Documentation Conventions Throughout this document, references to Treeview menu selections are surrounded by brackets ([ ]) and have vertical bars (|) separating entries from different menus. For example, [Other | Setup Parameters | Screen Colors] represents selecting the "Other" entry from the top level menu, the "Setup Parameters" entry from the Other submenu, and the "Screen Colors" entry from the Setup Parameters submenu. SECTION 2 INSTALLATION 2-1 System Requirements Treeview requires an IBM PC, PS/2 or compatible computer with 128K RAM or more to work properly. In addition, version 2.0 or greater of PC-DOS or MS-DOS is required. Treeview is "DESQview aware," meaning it can run in a small window under Quarterdeck Office Systems' DESQview (TM) multitasking program. To improve display speed, Treeview normally writes directly to the video screen memory of your computer. Treeview works well with the IBM Monochrome Display Adapter (MDA), Color Graphics Adapter (CGA), Enhanced Graphics Adapter (EGA), Video Graphics Array (VGA), and compatibles. Other video adapters that can emulate either the MDA or CGA should work properly. Treeview requires approximately 120K of computer memory to contain the program's executable code and common data. Additional memory is allocated as required to contain the file information for each open directory window and a copy buffer when copying files. The file information memory can either be allocated in conventional RAM or in LIM/EMS RAM if available on your system. You can change Treeview's total memory requirements by changing the number of files allowed per directory window. The largest setting, 2515 files per window, requires 64K of additional memory (conventional or EMS) per window. The default value of 1000 files per window requires approximately 26K (32K if EMS) per window. Since Treeview is not a memory resident Terminate and Stay Resident (TSR) program, the memory it uses is only required when you are actually running the program. The advantage to using EMS memory is to allow any programs executed from Treeview as much conventional DOS memory as possible for their own purposes. 2-2 Installing Treeview Installing Treeview is a very simple process--there are only three files required to run the program. They are TV.EXE (the program itself), TV.HLP (the help file), and TV.CFG (the configuration file). The TV.CFG file is optional in that Treeview will create a new TV.CFG file if it can't locate one when it starts up. If your system has a DOS PATH command setup, simply copy these three files into one of the directories identified in the PATH command. If you have a hard disk system, but you haven't set up a PATH command, you should read about it in the DOS manual or get someone knowledgeable to help you set one up. Optionally, you can copy the TV.CFG and TV.HLP files into a separate directory, and tell Treeview where they reside by setting the environment variable TVFILES to the name of the directory. This has an advantage over using a PATH directory, because only the single TVFILES directory needs to be searched when accessing the TV.CFG or TV.HLP files. The following command in the AUTOEXEC.BAT file informs Treeview to look for its files in the directory C:\TV: SET TVFILES=C:\TV When Treeview is started, it tries to read the TV.CFG configuration file. This file contains the configuration options that you've defined (for example, the display colors, the User Defined Key values, and the Point-and-Go values). If the TVFILES environment variable is defined, Treeview expects to find the TV.CFG file there. If TVFILES isn't defined, Treeview looks in the current directory; if TV.CFG isn't found there, the directories specified by the PATH command are searched. If the file still can't be located, a set of default parameters is used. Treeview must be able to locate the TV.HLP file when you ask for on-line help. If TVFILES is defined, Treeview looks for the TV.HLP file in that directory. If TVFILES isn't defined, Treeview looks in the current directory and then the directories specified by the PATH command. If the help file still can't be located, you'll be asked to supply the location of TV.HLP. If you are running a system with only floppy disks, it's recommended that you copy TV.EXE, TV.CFG and TV.HLP to your system disk (or disks if you have more than one system disk). The TV.HLP file is not accessed unless you actually request help, so it could be left off if you are short on disk space. SECTION 3 GETTING STARTED 3-1 Command Line Parameters The usual way to start up Treeview is to simply type TV and press Enter at a DOS command prompt. However, the following optional parameters can be specified on the command line to modify Treeview's behavior during a given run: /C or -C Instructs Treeview to only use conventional memory, even if LIM/EMS memory is available and the [Use EMS (if available)] option is enabled. /E or -E Allows use of LIM/EMS memory even if [Use EMS (if available)] option is disabled. /F or -F Do not perform video snow checking even if the [Video Snow Checking] option is set. /S or -S Perform video snow checking even if the [Video Snow Checking] option is disabled. /M or -M Indicates that the following parameter is a file name mask. See below for an example of a file name mask. /4 or -4 Uses EGA 43/VGA 50 line mode if available The Treeview command line can contain the name of the initial directory to display when Treeview is started. The following command: TV C:\LETTERS starts Treeview with the directory C:\LETTERS displayed, regardless of what the current directory was when the command was entered. Specifying a directory name on the command line is equivalent to starting Treeview without a directory name, and then using the Alt-L or [Dir | Login New Directory] command to switch to the desired directory. A file name mask to display specific file names can also be entered on the command line, but only immediately after a /M parameter. Supplying a file name mask on the command line works just as if the mask was specified with the [Other | Selection Criteria | File Name Mask] command. For example, the command line: TV /M *.DBF invokes Treeview and tells it to only display files that have an extension of .DBF The file name mask must follow the /M parameter on the command line. Several parameters can be entered on the same command line. For example: TV/S/C/M *.COM D:\BIN starts Treeview with video snow checking enabled (/S), EMS usage disabled (/C), and only files with the extension .COM in the directory D:\BIN displayed. Refer to the topics USING LIM/EMS MEMORY and VIDEO SNOW CHECKING for more information on EMS memory and video snow checking. You can access Treeview's on-line help any time it is waiting for input by pressing the F1 function key. There are four areas on the main file display; the menu bar, the header area, the file name area, and the status line. The contents and usage of the different screen areas are described below. 3-2 Menu Bar The menu bar across the top line of the screen shows the top level functions which Treeview can perform. You select a function from the menu bar by pressing the key that is the first letter of the desired function. Depending on your computer's video equipment and your video attribute/color setup, the first letter of the menu bar choices may be displayed in a different color or otherwise highlighted to make them stand out visually. In most cases, selecting a function from the menu bar results in a "pull-down" submenu being opened. Submenus are a set of choices that appear in a box under the corresponding top level option. You select a submenu entry by either pressing the key that is highlighted in the submenu entry (not always the first letter), or by using the up and down arrow keys to highlight the desired entry and then pressing Enter. The Esc key can be used to exit a submenu without selecting any of the choices. Please refer to the APPENDIX A for a "map" of the keystrokes to navigate the commands available within Treeview's menu bar. In addition to the menus, many of Treeview's most common functions can be performed by the function and control keys and Alt key combinations. Function, control and Alt key usage is described in the Section 4, Appendix A, and in Treeview's on-line help. Here is an example showing the menu bar and an open submenu (in this case, the Files submenu). When displayed on your computer's screen, actual graphics characters are used, making a much nicer display. Dir Files Help Other Sort Tag/Untag Windows Xecute Quit ----+-----------------------------+----------------------------- | Set File Attributes | | Copy File(s) | | Set File Date/Time | | Erase File(s) | | Extra File Info Alt-I | | Rename/Move File(s) | | View File Alt-V | | Xecute File Alt-X | +-----------------------------+ 3-3 The Header Area The header area at the top of the screen contains information about the current disk drive, the current directory, and Treeview options. The header section entitled "Volume" displays the volume label of the current disk, the total storage capacity of the disk in bytes, and the size of the remaining free space on the disk, also in bytes. If the current disk does not have a volume label, the label area is blank. The header section entitled "Path" normally displays the complete pathname of the current disk drive and directory. In either the show-all or show-sub modes, the Path area displays the pathname of the current file. The header section labeled "Files" displays the number of files listed in the file name area, the total size of those files in bytes, the number of files tagged for group operations, and the size of tagged files in bytes. The final header section, "Selection", displays the selection criteria used to pick which files are displayed in the file name area. More information on the Selection area is provided in the QUICK REFERENCE section. Following is an example of the header area, edited to fit on this page. + Volume -+- Path -----------------------------------------------+ |AUTOMENU | C:\COMM | | +------+- Files ----------------------+- Selection ----+ | 21309440 TOTAL | SELECTED: 7 FILES 768 BYTES | MSK: | | 11669504 FREE | TAGGED: 0 FILES 0 BYTES | ATR: N . . . A | +----------------+------------------------------+----------------+ 3-4 The File Name Area The file name area usually displays a sorted list of the file names in the current directory. If there are more file names to be shown than will fit on the screen at one time, you can use the arrow keys or the PgUp, PgDn, Home, and End keys to display the other file names. You can select the manner in which the files are sorted for display with the [Sort] command, and you can specify that they be sorted by Name, Extension, Date, Size, or Unsorted, in Ascending or Descending order. More details on using the [Sort] command are in Section 5 as well as Appendix A. Many of the Treeview commands operate on the current file. The current file is identified by being the only highlighted name in the file name area. The four arrow keys and the PgUp, PgDn, Home, and End keys can be used to select a different current file. The highlighted bar over the file name is sometimes called the current file pointer or just the file pointer. The file name area can be split into multiple windows to display different disk drives and/or directories on the screen at the same time. Only one window is current at a time (sometimes called the current window). 3-5 The Status Line The status line appears along the bottom line of your computer's screen. It is divided into three segments. The first segment tells you what Treeview is doing and when it is ready for your input. The second segment simply reminds you that you can press the F1 function key for on-line help. The third segment shows whether or not the DOS verify mode is set on or off. Following is an edited example of the file name area (with two file windows displayed) and the status line. +| C:\ |--------------------------------------------------------+ | AUTO\ BRATEMM.SYS JDISK.SYS QEXT.SYS | | AUTOMENU.COM DV\ LIB\ SRC\ | | BATCH\ DV.BAT MOUSE.SYS WRITE\ |<-- File | BIN\ COMM\ FC\ | Window | BRATDISK.COM COMMAND.COM GRAPHIC\ | #1 +| C:\SRC\TV |--------------------------------------------------+ | CVTHLP.C GRAPHIC.H MVFMOVE.C MVVBUF.C | | CVTHLP.EXE KEYS.H MVFMOVE.FUN MVVIEW.BAK | | DATE.ASM LOGO.ASM MVFUN.BAK MVVIEW.C |<-- File | DIALOG.C LOGO.BAK MVFUN.H MVWIN.C | Window | DIALOG.H MENU.C MVHELP.BAK PATHNAME.C | #2 +---------------------------------------------------------------+ +| Ready! | Press F1 for Help | Verify: OFF |+<-- Status +---------------------------------------------------------------+ Line 3-6 The Help System Treeview has an extensive on-line help system available at the press of the "H" key. Help is broken up into six major areas: Treeview Commands Input (Keyboard and Mouse) Treeview Menus Program Parameters Registering Treeview Treeview Screens Within the [Help | Commands] option, further help is available on these subjects: Directories, Files, Viewing and Executing files, and Sorting and Tagging files. Help is also given on customizing Treeview's screen colors, default settings, user defined keys, "Point-and-Go" keys, Video options and more. Please refer to Appendix B for a more detailed "map" of the entire Treeview help system. SECTION 4 IMPORTANT KEYS WITHIN TREEVIEW The on-line help facility should be used to supplement the information presented in this section. You can get help any time the program is waiting for input by hitting the F1 key. 4-1 ALT Key Usage Treeview has a number of Alt-key combinations that are shortcuts to many of the most common functions. Entering one of the following Alt-key combinations executes the corresponding menu entry, without traveling through the menus. Menu entries that have Alt-key shortcuts will display the shortcut at the right edge of the menu line. Alt-key combinations are performed by pressing and holding down the ALTernate key while tapping the second key, the releasing the alternate key. For example, "Alt-A" means to hold the ALT key down and tap the "A" key, then release the ALT key. Some of these special key combinations available within Treeview are as follows: Alt-A Files | Set File Attributes | Current File Alt-B Files | Set File Attributes | Tagged Files Alt-C Files | Copy file(s) | Current File Alt-K Files | Copy file(s) | Tagged Files Alt-F Files | Edit File Alt-E Files | Erase file(s) | Current File Alt-Y Files | Erase file(s) | Tagged Files Alt-R Files | Rename/Move File(s) | Current File Alt-M Files | Rename/Move File(s) | Tagged Files Alt-I Files | Extra File Information Alt-V Files | View File Alt-G Dir | Login New Drive Alt-L Dir | Login New Directory Alt-N Dir | Reread Current Directory Alt-T Dir | Show Dir Tree Alt-S Other | Setup Parameters Alt-P Other | Setup Parameters | Point and Go Setup Alt-U Other | Setup Parameters | User Defined Keys Alt-D Xecute | DOS Command Alt-X Xecute | Current File Alt-Q Quit 4-2 Control Key Usage Treeview allows several Control-key combinations to be used in addition to the arrow and keypad keys. The Control-keys add a WordStar (TM) like interface to Treeview. The sequence ^R means to hold down the Ctrl key and simultaneously press the 'R' key. ^R - Same as PgUp ^G - Same as Del ^C - Same as PgDn ^V - Same as Ins ^H - Same as backspace ^W, ^E - Same as up arrow ^M - Same as Enter ^Z, ^X - Same as down arrow ^T - Tag/untag current ^A, ^S - Same as left arrow file ^D, ^F - Same as right arrow 4-3 Function Key Usage Treeview uses the function keys on the keyboard to execute several common functions with a single key. The function key usage is: F1 - Get Help F2 - Tag/Untag the current file (toggles current tag state) F3 - Login to the parent directory F4 - Login to the subdirectory under the file pointer F5 - Goto the next tagged file (next find in VIEW) F6 - Goto the previous tagged file (prev find in VIEW) F7 - Open another file name display window F8 - Close the current file name display window F9 - Goto the next file name display window F10 - Goto the previous file name display window The Alt-Fn, Shift-Fn and Ctrl-Fn (function key) combinations are called User Defined Keys and are described in the topic of the same name. 4-4 The ESC Key The Esc key quits or aborts whatever operation Treeview is currently performing. The exact effect of pressing Esc depends on the operation being performed. At the highest level, the Esc key returns to the normal file name display from viewing a file, viewing the directory tree, setting color selections, and the on-line help facility. Many of Treeview's submenus do not have a selection to quit or exit without performing a function. The Esc key does this by closing the last opened submenu. When multiple submenus are open, they can be closed in reverse order by pressing Esc once for each submenu. The Esc key also escapes from most pop-up window prompts. For example, selecting the [Dir | Login New Directory] command pops up a window asking which directory to log in. If you decide not to switch to another directory, just press the Esc key and the window will disappear. 4-5 Other Important Keys While Treeview's file windows are displayed, you may press the grey "plus" or "minus" keys to tag and untag files. These keys are the same as the F2 function key, which tag and untag files each time you press them. This is known as a "toggle" switch, because each time you press the key, the other action is performed. Pressing a toggle key once will tag the file currently highlighted, and pressing it again will untag it. When using the grey plus and minus keys, you will notice that after tagging or untagging a file, the highlight bar moves down to the next filename in the display window. If you have your files sorted in the proper order, you will be able to mark an entire block of filenames simply by repeatedly depressing the grey plus key. Please note that the F2 key works in the same way - after you press it, the highlight bar will move down one file. The equals key is also very important in Treeview. Whenever you press the equals key, followed by a letter or number, Treeview will immediately move the highlight bar to the first occurrence of a filename that matches that letter or number. More details on the "file find" feature of Treeview can be found in section 5-4. 4-6 The Mouse Here is a summary of the mouse capabilities built into Treeview: 4-6.1 Mice - Generally Speaking Generally speaking, the left mouse button selects an operation while the right button cancels or quits the operation in progress, but there are exceptions. 4-6.2 Executing Files With the Mouse While the main file window is shown on the screen, the mouse can select a file by pressing the left button while pointing at it. A rapid double-click of the left mouse button will attempt to execute the file being pointed at (same as Alt-X). If the file does not have an extension of .COM, .EXE, or .BAT, Treeview will check to see if a point-and-go key has been set up and attempt to perform that action on the file. If none of these are true, the file will be viewed. While looking at the directory tree, a single click of the left mouse button will move the highlight bar to that directory. A rapid double-click on that entry will log in to that directory (same as using the cursor keys to highlight a directory and then pressing enter to log into it). When multiple file windows are open, clicking the left mouse button on any file in a window will make that window the current one and also highlight the file. 4-6.3 Tagging Files With the Mouse To tag a file, point at the file desired and press the right mouse button. To untag a file, point to it and press the right mouse button again. 4-6.4 Scrolling Around With the Mouse In each file window that is open, and when looking at the directory tree screen, you will notice a set of four arrows in the upper right corner. Clicking the left mouse button on one of these arrows will move the file or directory pointer in the indicated direction, similar to pressing the corresponding cursor control key. 4-6.5 Viewing Files With the Mouse While viewing a file, the left mouse button can be used to select any of the commands on the menu bar. The Up and Down, Left and Right commands are implemented by pointing at them and pressing the right mouse button. You can also point at these commands and depress and hold down the mouse button to repeat the same command more rapidly. For instance, while viewing a file, you can point at the Down command on the menu bar and hold down the left mouse button to effectively "scroll" down through your document. Similarly, by pointing at the Up command and holding down the left mouse button, you can scroll upward through your file. 4-6.6 Dragging the Mouse Another concept of the mouse is one called "dragging", and it is usually done by holding down a mouse button while moving the mouse. In Treeview, you can select a series of files from a window simply by holding down the right mouse button while slowly moving your mouse over the files to be tagged. The mouse's location is updated by the program approximately every one-ninth of a second, so you can't move too quickly. Using a mouse with Treeview is not mandatory, but it can simplify moving around and selecting files to operate on. A mouse is a more "friendly" way of dealing with the drop down menus and pop-up windows that Treeview provides, and while there is a keyboard equivalent of almost all mouse operations, we feel that using a "rodent" can definitely help the learning curve of any program. SECTION 5 ELEMENTS OF TREEVIEW Treeview is a hard disk file maintenance utility. Its strengths lie in its ability to copy files, move files, rename files, delete files, change file attributes, sort filenames, and perform operations on one or more of those files. Here in Section 5 we will discuss what Treeview is and exactly what it does. First, we will discuss the most important feature of Treeview: the ability to display a graphic directory "tree" of the files on your system. 5-1 The Directory Tree When the directory tree is displayed by Alt-T or the [Dir | Show Dir Tree] command, a graphic tree somewhat like the following is shown: C:\ ---------+ AUTO + CATDISK + COMM --------+ AQUARIUS | + MERCURY + GRAPHIC -----+ DRAW | + PAINT + INCLUDE -----+ SYS + MAGEE -------+ AUTOMENU + SRC ---------+ TV + WRITE -------+ ARTICLES + WS The tree represents the structure of the directories on the current disk drive. Each column to the right indicates another subdirectory. The directories described by the tree above are: C:\ C:\AUTO C:\CATDISK C:\COMM C:\COMM\AQUARIUS C:\COMM\MERCURY C:\GRAPHIC C:\GRAPHIC\DRAW C:\GRAPHIC\PAINT ...and so on. The current directory is shown under a highlighted bar (called the directory pointer). You can switch to another directory by using the up, down, right, left arrow keys to highlight the new directory. In addition, the Home key moves to the top level or "root" directory and the End key moves to the lowest rightmost directory. Treeview does not actually switch (or "login") to the new directory until you press the Enter key or select the [Login] option from the directory tree menu bar. As you move the directory pointer around the tree, the currently logged in directory remains displayed in a different color/video attribute. This is the directory to which Treeview returns if you press the Esc key or select the [Quit] option from the directory tree menu bar, regardless of the directory pointer location. With the directory tree [Write] command, you can save the directory tree information in a single disk file (named TV.DIR in the top level directory of the current disk). When you bring up the directory tree display, Treeview checks for this disk file--if it exists, the directory tree information is read from the file instead of searching the disk for directories. This results in a much faster tree display. If you change your disk's directory structure outside of Treeview, you can force a rescan the entire disk for directories (instead of just reading the TV.DIR file) by using the directory tree [New] command. This informs Treeview of the changes you've made to directories since the last time the disk was scanned. The directory tree [Mkdir] command (similar to the DOS command of the same name) "makes" a new subdirectory "under" the directory pointer. For example, if you select the [Mkdir] command while the directory pointer is on the directory C:\123\SALES, and you enter "JOURNAL" as the new subdirectory name, Treeview creates the directory C:\123\SALES\JOURNAL. New directories created by [Mkdir] immediately appear in the graphic tree display. The directory tree [Rmdir] command (also similar to the DOS command of the same name) deletes or "removes" the subdirectory under the directory pointer. Selecting [Rmdir] when the directory pointer was on the directory D:\FORMS\LETTERS\SUPPORT will delete the SUPPORT directory, provided the following conditions are meet: - You can't delete the directory you're currently logged in to (the current directory). - You can't delete the top level (root) directory of a disk. - You can't delete a directory that contains any files and/or other directories. If you want to delete a directory that contains files, delete the files first using the [Files | Erase File(s)] command. There are two directory tree options that are useful in conjunction with the [Write] command. Both options are related to writing the directory tree file to disk whenever changes are made in the disk's directory structure. Keeping the file synchronized with the actual directory structure is important since Treeview does not scan the disk for directories if the TV.DIR file exits (unless you use the [New] command as noted above). The first option, [Other | Setup Parameters | Directory Tree Options | Select Drives to Always Write] allows you to specify a set of disk drives which are to automatically have the TV.DIR file rewritten whenever you exit the directory tree and there were directories created or deleted. A useful application of this option is to specify all your computer's hard disks. The drives should be specified as single letters, with or without colons (:) and spaces. The second option, [Other | Setup Parameters | Directory Tree Options | Prompt to Write when changes] causes Treeview to ask you if the TV.DIR file should be written when changes have been made in the directory structure. This option is useful when you may or may not want to write to the disk. If neither option is specified, Treeview does not write the directory tree file to disk unless you explicitly use the [Write] command to do so. 5-2 Extra File Information Treeview can display three levels of detail about files stored on disk. The level of detail displayed is changed with the Alt-I or [Files | Extra File Info] command. A default level of detail can be set with the [Other | Setup Parameters | Startup Defaults | Extra File Info (1 col)] and [ Other | Setup Parameters | Startup Defaults | Extra File Info (2 col)] options. The lowest level shows only file names, and is illustrated below: ANSI.SYS COMMAND.COM DRIVER.SYS JDISK.SYS QEMM.SYS AUTOEXEC.BAT CONFIG.NEW DUET\ LIB\ RES86.COM BATCH\ CONFIG.OLD DV\ MOUSE.SYS SRC\ At the lowest level of detail, Treeview is able to show five columns of file names per window. The second level displays full information on each file. In addition to the file's name; its size, creation or modification date and time, and attributes are shown. An example of the full file information display is shown below: NAME USED ALLOCATED DATE TIME R H S A DIR ANSI.SYS 4963 6144 7/20/87 1:00:00 pm . . . . AUTOEXEC.BAT 1134 2048 11/27/87 8:01:26 pm . . . . BATCH\ <DIR> <DIR> 11/21/87 5:31:52 pm . . . . DIR BIN\ <DIR> <DIR> 11/21/87 5:16:48 pm . . . . DIR IBMBIO.COM 16557 18432 7/20/87 1:00:00 pm R H S . IBMDOS.COM 28464 28672 7/20/87 1:00:00 pm R H S . Each file (except for directories) shows two file sizes, USED and ALLOCATED. Due to the manner in which DOS stores files on disk, a file often requires more space than it actually uses. The file size reported in the USED column is the amount of useful data actually in the file. The size reported in the ALLOCATED column is the amount of space allocated or reserved for the file. The allocated (but unused) space is not available for other files to use. A file's attributes are shown as a single character if the attribute is on, or a period if the attribute is off (R - Read/Only, H - Hidden, S - System, and A - Archive). The Directory attribute is shown by the characters DIR. When full file information is being displayed, only one column of file names can be shown per window. The third level of detail displays some, but not all, of the information per file. The fields shown are: name, file size, and creation or modification date and time. The allocated size and file attributes are not shown, allowing two columns of file names to be shown per window. An example is shown below (only one file per row will fit on the printed page): ANSI.SYS 4963 7/20/87 1:00p AUTOEXEC.BAT 1208 3/24/88 1:40p BATCH\ <DIR> 2/14/88 11:03p 5-2.1 File Sorting Treeview can sort the files for display in a variety of formats. The choices you have for sorting files are as follows: by Filename, by extension, by date, by size, or unsorted. You can also specify ascending or descending order. Please note that when sorting files for display, no files are actually relocated, just shown onscreen in the manner you have specified. One of the benefits to sorting files is to group logically similar ones together. When sorting by extension, all your batch files (.BAT) will be listed together, all the program files (.EXE and .COM) and text files (.TXT and .DOC, for example) will be grouped together, and so on. This would be a nice way to use Treeview if you needed to know about only a certain type of file, for example. If you sort the files by size, the smallest files will be listed first, and the largest will be listed last because this is considered ascending order. If you tell Treeview to sort in descending sequence, the large files would be shown first, followed by successfully smaller files. Sorting the files by date will display the oldest files first, followed by newer ones, again because this is ascending order. Unless otherwise selected, ascending order is used by default when performing sorts within Treeview. 5-3 File Selection Attributes File Selection Attributes allow you to work with a select group of disk files, based on the DOS file attributes that the files themselves have. The following attributes can be used for file selection: Normal - Selects files which have none of the following attributes set. This is not really a DOS file attribute, but it's useful to treat it as one. Archive - Selects files which have the Archive attribute set. DOS sets the Archive attribute when a file is created or modified. Dir - Selects files which are subdirectories. Hidden - Selects files which have the Hidden attribute set. Read/Only - Selects files which have the Read/Only attribute set. System - Selects files which have the System attribute set. As distributed, Treeview's default file selection attributes are N (Normal), R (Read/Only), A (Archive), and D (Dir). This means that only files with normal attributes (that is no attributes), the Read/Only attribute, the Archive attribute, or the Directory attribute are displayed. Selection attributes work by only displaying files that have one or more matching attributes. A file which does not have any matching attributes is not displayed. The current file selection attributes are shown in the header "Selection" area. The displayed attributes are abbreviated to their first letter. There are two commands that set file selections attributes; [Other | Selection Criteria | by Attribute] and [Other | Setup Parameters | Startup Defaults | Selection Attribs]. The [Other | Selection Criteria | by Attribute] command sets the selection attributes for the current file name window. This command allows different windows to be given different selection attributes, thereby displaying different collections of files. When this command is used, Treeview rereads the current window's directory (or directories if show-all or show-sub mode is active) and only displays those files which match the new attributes. As an example, you can display all modified files on your disk (and only the modified files) by using [Other | Selection Criteria | by Attribute] to turn off all attributes except Archive. Then use [Dir | Show All Dirs] to read all directories on the disk. Only the modified files (those with the Archive attribute set) will be displayed. The other selection attribute command, [Other | Setup Parameters | Startup Defaults | Selection Attribs] sets Treeview's default selection attributes. These are the initial attributes used every time you start Treeview. Treeview is distributed with the Hidden and System attributes turned off since files with these attributes are not typically manipulated by users. If you like to see every file in any given directory, change the default attributes to include Hidden and System files. 5-4 Find File Name The Find File Name command moves the file pointer to the first file name in the current window that matches the characters you specify. To search for (find) a given file name in the current window, first press the equals (=) key. Each character typed after the '=' key further defines the file name to find. For example, typing '=T' moves the file pointer to the first file in the window that starts with the letter 'T'. If you then type the letter 'V', the file pointer will move to the first file name starting with 'TV'. If you type a character for which there is no matching file name, a beep will sound and the file pointer will not move. You can change the name to search for by using the Backspace key, all the way back to the '=' key. The status line at the bottom of the screen contains the current file name search string and brief instructions after typing '='. The Find File Name command can be terminated by the Esc key and most other non alpha-numeric keys and commands. The sequence =TV Ctrl-T moves the file pointer to the first file name starting with TV and tags that file. It's important to realize that the Find File Name command does not search the disk for a given file, it only searches the list of names in the CURRENT DIRECTORY WINDOW. If the file name is not in the window, Find File Name will not find it. To use this command to search for a specific file somewhere on disk, use it in conjunction with the [Dir | Show All Dirs] command to search all file names on the disk. 5-5 Show-All and Show-Sub Modes Normally Treeview displays the contents of a single directory in each file name window. This mode of operation matches the way most people organize their data on disk - related files are put together in the same directory. At times however, it's more convenient to see all the files in a given set of directories, or even all the files on a disk. The [Dir | Show All Dirs] and [Dir | Show Sub Dirs] commands do just that. [Show All Dirs] displays all files on the current disk (called show-all mode) and the [Show Sub Dirs] command displays all files in the current directory and any directories under the current directory (called show-sub mode). The Path section of the header displays the directory name of the current file so that you can tell in which directory a given file resides when Show-All or Show-Sub mode is active. As you move the file pointer through the displayed file names, the Path changes to show the location of the current file. Normally all file names displayed in a window would be in the same directory, so the Path section wouldn't change from file to file. Selecting [Show All Dirs] or [Show Sub Dirs] a second time turns off the corresponding mode and restores the display of the files in the current directory. You can use these commands in conjunction with the selection mask and/or selection attributes to limit the files displayed. For example, a selection mask of *.EXE combined with [Show All Dirs] displays all EXE files on the current disk. Show-all and show-sub modes are one Treeview's most powerful features. In these modes, you can work with all the files on the disk (or in a given directory tree) just as easily as you could with the files in a single directory. Some examples of show-all/sub uses are: 1) Erase all the .BAK files on drive C. - Select all files on drive C [Dir | Show All Dirs]. - Tag all files with the extension .BAK [Tag/Untag | by Name]. - Erase all tagged files [Files | Erase File(s) | Tagged Files or Alt-Y]. 2) Turn off the Archive attribute of selected files so the DOS BACKUP program will not copy them to disk. - Select all files [Dir | Show All Dirs]. - Tag all modified files [Tag/Untag | Modified]. - Display only the tagged files [Tag/Untag | Select Tagged]. - Untag (F2 key) the files which are to be backed up - leaving only modified files not to backed up still tagged. - Turn off the Archive attribute of the tagged files [Files | Set File Attributes | Tagged Files or Alt-B]. 5-6 Subdirectories DOS allows subdirectories to be given names just like any other type of file. When looking at a list of file names, it's easy to forget which names represent files and which names are actually subdirectories. To make the distinction clear, Treeview displays directory names with a backslash character (\) following the name. The following list shows several file and directory names as they would be displayed by Treeview: ANSI.SYS COMMAND.COM DRIVER.SYS JDISK QEMM.SYS AUTOMENU\ CONFIG.SYS DUET\ LIB\ SRC\ BATCH\ CONFIG.OLD DV\ NOTES In addition to the [Dir | Login New Drive] and [Dir | Login New Directory] commands, the F3 and F4 function keys can also be used to change directories. The F3 key will login to the parent of the current directory, up to the top level root directory on the current disk. The F4 key will login to the subdirectory under the file pointer. 5-7 Terminate and Stay Resident Utilities and Treeview Terminate and Stay Resident (TSR) programs load into memory and remain there when executed. You should be careful to avoid loading TSR routines from Treeview since the TSRs would be placed above Treeview in memory. When you exit Treeview, an unused "hole" would be left in memory where Treeview used to reside. This hole in the computer's memory would generally cut down on the amount of memory available to other programs executed after quitting Treeview. This is true not only of Treeview, but many other programs that also give you access to DOS. One common DOS command, the PRINT command, is a TSR utility that remains in memory after being loaded the first time. If you're going to use the PRINT command from within Treeview, make sure that PRINT is used at least once before starting Treeview. The following command could be added to your AUTOEXEC.BAT startup file to load the resident portion of the PRINT command whenever the computer is turned on or restarted. PRINT /D:PRN >NUL: The >NUL: on the command line simply keeps a couple of messages from the PRINT program from appearing on the screen. This command should work in DOS versions 3.1 and above. Refer to your DOS manual for more information on the PRINT /D command option. 5-8 Update Target Directory When maintaining backup copies of files, or working with the same set of files on multiple computers, it's often necessary to update your files so that all copies of the same file are indeed the same version. Treeview's [Dir | Update Target Directory] command provides a convenient way to synchronize the files in different directories or disk drives. Two directories are used by the [Update Target Directory] command; the source and the target. Treeview selectively copies files from the source to the target, so that the target directory contains the same files as the source. What makes this command more convenient than a simple copy is that it only copies the files in the source directory that were created or modified more recently than the corresponding files in the target directory. The source directory is always the current directory when the [Update Target Directory] command is executed. Treeview prompts you to enter the name of the target directory before copying any files. The [Dir | Update existing files only] option modifies the behavior of the [Update Target Directory] command. When this option is off, all files in the source directory are checked against the target, and are copied if more recent or if they don't exist in the target directory. When the [Update existing files only] option is on, only files already in the target directory will be updated. Files in the source directory but not in the target will NOT be copied. Because Treeview uses the creation/modification date and time to determine if the files are the same or not, it's important that the date and times be accurate for this command to work properly. If your computer system doesn't have a real time clock, make sure the date and time is set correctly whenever the computer is turned on or restarted. 5-9 Window Commands Treeview can display from 1 to 6 file name windows on the screen at a time. Each window is independent of the others and can display the same or a different drive/directory. File name windows are opened, closed, and switched with the [Windows] command. When you start Treeview, it initially has one file name window open, displaying the contents of the current directory. As you open and close additional windows with the [Windows | Open] and [Windows | Close] commands, the size of the windows will be adjusted so that all open windows have an equal amount of screen space. The F7 and F8 keys are short-cuts for opening and closing windows, respectively. Only one of the open windows can contain the file pointer at a time; this is called the current window. The Path, Files, and Selection sections of the header area at the top of the screen always display information about the current window. As you move the file pointer from window to window with the [Window | Next] and [Window | Prev] commands, the header area updates to reflect the current window status. The F9 and F10 keys are short-cuts for moving to the next or previous window, respectively. A newly opened file name window displays the same directory as the current window, and it also inherits the current window's sort options, tagged files, and selection criteria. If you want the new window to display a different directory or disk drive, use the [Dir | Login New Directory] or [Dir | Login New Drive] command to switch to the desired directory or drive. Commands that operate on files only effect the directory shown in the current window. For example, when you erase all tagged files with the [Files | Erase File(s) | Tagged Files] command, only the tagged files in the current window's directory are erased. [Erase File(s)] does not effect any tagged files in other directories. Closing a file name window removes the window from the screen display. Closing a window has no effect on the files themselves, it simply removes the window from the display. Windows are very useful when working with two or more directories at the same time. For example, when copying a set of files from a hard disk to a floppy, or when moving files from one directory to another. 5-10 Interrupting Tagged File Operations When performing an operation on all tagged files (copy tagged, rename tagged, erase tagged, etc.), the Esc, Ctrl-U, Ctrl-C, or Ctrl-Break keys can be used to interrupt the process. Striking one of these keys during a tagged file operation causes the message "Interrupt?" to be displayed. Respond Y to stop the operation, N to continue. Interrupting a tagged file operation doesn't restore files that have already been processed, but it can keep further files from being modified. We recommend that you do NOT interrupt tagged file operations that involve more than one DOS command (i.e., REN $T $T.BAK^DEL $T^MODE BW80). 5-11 Editing Responses When you are prompted for a response in a pop-up window (for example, when logging in to a new directory or when entering a DOS command to execute), the response can be edited with the Home, End, Ins, Del, backspace, left arrow, and right arrow keys up until the time you press the Enter key to end the input. The Home and End keys move the cursor to the left and right ends of the response, respectively. The Ins key turns insert mode on and off, allowing existing data to be overtyped (when off) or new data inserted (when on). The cursor is made larger when insert mode is turned on. The Del key deletes the character at the cursor position, while the backspace key deletes the character just to the left of the cursor. The left and right arrow keys simply move the cursor in the corresponding direction. The up and down arrow keys can also be used when entering a response. Treeview keeps the last 10 responses entered, and recalls the next oldest response each time the up arrow key is pressed. The recalled response can be edited or accepted (by pressing Enter) just as if it had been typed in again. If you go past the response you wanted with the up arrow key, the down arrow can be used to recall the more recent responses. Finally, the PgUp and PgDn keys also effect the entry and editing of responses. Pressing the PgUp or PgDn key when entering a response inserts the name of the directory displayed in the file name window above or below the current window, respectively. Each time the PgUp or PgDn key is pressed, the next higher or next lower window's directory name is inserted. This is useful when performing operations such as copying files or logging in to another directory. 5-12 External Functions of Treeview Treeview can perform several "external" procedures - running any DOS program, calling a user defined file editor or listing utility, and more. This ability is usually referred to as a "shell", meaning that Treeview can provide an user interface to the computer instead of the standard DOS prompt (C:>). By using a shell, users can normally be more productive with less understanding of the commands available from the normal DOS prompt. The shell is an environment that provides on-line help, colorful screen displays, easy performance of repetitive tasks, and a common place of reference for the user. A task is performed from the shell and then control is returned to the shell program. In Treeview's case, this means that you can just point to a program or executable file, hit the Alt-X key and run it. When the program is finished, you are returned to Treeview. Treeview can be configured to either run its own internal file viewer or one of your own selection. Similarly, you can set up an external editor to be called with a single keystroke from within Treeview that will allow the user to perform quick revisions to text files, batch procedures, or other ASCII files. Magee Enterprises Inc. has another product that can be considered a shell program, and it is called Automenu (R). Where Treeview is file oriented (point at a file and perform an action on it), Automenu is application oriented (point to an option on a menu and perform it). Both are examples of shell programs because both allow you to perform complex tasks more easily with them than without them. More details on the external functions of Treeview are outlined in Appendix A. 5-13 File Oriented Operations With many of Treeview's file oriented operations, you must first tag (mark) the files to be processed and then perform some type of command with those tagged files. This is done by several means. You can move the highlight bar to a file and then either press the grey "plus" key or the F2 function key. This will mark the file as "tagged" and then proceed down to the next filename that is displayed in the window. You can also use the menu bar option at the top of the screen called Tag/Untag. Do this by pressing the letter "T". Then you have the option of tagging files by name where you can specify a file mask that fits the files you want to process. You can specify "*.BAK" to tag all files with that extension, or "STAR.*" to tag all files with that filename. There are other options under the Tag/Untag function that allow you to select files by date and time, if they have not already been tagged (Invert), files with todays date, files with the archive attribute set (Modified), and to untag all tagged files. Check Appendix A for the logic map on using the Tag/Untag menu option. 5-13.1 Copying Files After tagging the selected files you wish to copy you will return to the main display screen. From here you must press "F" to access the Files menu bar option, and then "C" to copy files. You will be asked if you want to copy the Current file or all Tagged files. Press "T" to copy a series of tagged files, and then answer the prompt about the destination for the files to be copied to. To copy tagged files to another drive, just input the name of the drive to be copied to (A:, etc.). If there is a special subdirectory that you wish the files to be copied into, specify that when Treeview asks for the destination (D:\FileDirectory, etc.). 5-13.2 Renaming and Moving Files Treeview has a rather simple approach to moving files - it merely renames the path associated with the filename so that DOS will keep track of it in another subdirectory. Instead of making a copy in another subdirectory (with the inherent space taken by duplicating files) and then deleting the original as so many file products do, Treeview just renames the path specification to the file you are renaming. For example: C:\AUTOMENU\MARSHALL.MDF can be "moved" to another subdirectory by renaming it to C:\BACKUP\MARSHALL.MDF or C:\PUBLIC\MARSHALL.MDF There is no reason to duplicate the file when DOS will accept the renamed path specification as part of the new filename. This effectively "moves" a file LOGICALLY without moving it PHYSICALLY. 5-13.3 Viewing Files Treeview has a built-in file listing utility that will automatically switch between ASCII and hexadecimal modes, depending on the format of the file you wish to view. By just placing the highlight bar over a file and pressing RETURN you will see the contents of the file displayed on the screen. This is important if you need to look at several files before deciding which one you might wish to edit. View any current file by pressing "F" for Files and then "V" for View. The highlighted file will then be displayed on the screen. A shortcut would be to highlight a file and then press Alt-V. If the current (highlighted) file is in ASCII (text) format, it will be displayed in full screen format. If it is not ASCII, it will be displayed in hex format - the left two thirds of the screen will show the hexadecimal representation of each byte in the file, with the printable equivalents shown on the right one third. This version of Treeview allows you to use either the native file lister included with the product, or configure one of your own. Please refer to Section 6 for tips on "Customizing Treeview". 5-13.4 Editing Files There is no editor built into Treeview, so this is what we call an "external" function. It is something that you can set up, but will not operate if you do not do so. From the main display you can press [Other | Setup Parameters | External Program Hooks | File Editor] to access a screen that will ask you for the "command prototype" of the editor you wish to use. The command prototype is in the same form as those discussed in Section 6-4 and 6-5, and makes use of the DOS macros explained in Section 6-2. Typically you would tell Treeview to use a command prototype that looks like this: EDITOR $F where "Editor" is the command to start your choice of editing programs, and "$F", a DOS macro, which will be substituted by the full path and filename of the current file. This will allow you to highlight a file from the main screen and then press Alt-F ([Files | Edit File]) to start your editor and pass to it the name of the highlighted file. 5-13.5 Resetting File Date and Time The date and time attributes of any file(s) can be changed by using the [Files | Set File Date/Time] command. Treeview will ask if you want to change the current file or all tagged files, and then present a pop up window displaying today's date and time. You can press the return key to use this data, or input your own specifics and then press return. In any event, changing file dates and times can be a convenience for those who must track files by their vintage, such as a software librarian or programmer. SECTION 6 CUSTOMIZING TREEVIEW 6-1 Screen Colors The [Other | Setup Parameters | Screen Colors] command allows you to customize the video attributes Treeview uses to display various types of information. On a color display monitor, the video attributes determine which colors are displayed. On a monochrome monitor, the attributes select display options such as underlined, inverse video, and intensity. You can specify video attributes for ten different types of displayed text. They are: Normal text, Highlighted text, Window text, Highlighted window text, Heading text, Background text, Tagged file name text, Menu text, Highlighted menu text, and Selected menu text. The easiest way to determine what the different types of text are is by changing the colors and observing the results. When you select the [Other | Setup Parameters | Screen Colors] command, the display shows the types of text that can be selected, the attribute combinations allowed, and short directions. The PgUp and PgDn keys on the numeric keypad select the type of text to define, while the arrow keys select the particular display attribute for that type of text. The current type of text and the current attribute are always indicated by > TEXT < characters. When changing video attributes, three choices are available from the menu bar; Accept, Reset, and Quit. Use the [Accept] option to begin using the color combination you've selected. If you've selected a set of attributes you don't like, you can use the [Quit] command to return to the previous attribute settings. With the [Reset] command, you can restore the default (permanent) settings even if you've accepted other attributes. [Reset] restores the last settings that were written to the TV.CFG file. 6-2 DOS Command Macros A set of command line "macros" are available for use wherever Treeview accepts input of a DOS command ([Xecute | Current File], [Xecute | DOS Command], User Defined Keys, and Point-and-Go commands). Before executing the DOS command, Treeview replaces the macro with its value. The supported macros are: $C - The current file name, with extension. $D - The current drive letter, without a trailing colon (:). $F - The full pathname of the current file, including drive, directory, and file name (with extension). $P - The directory pathname for the current or tagged file, without a trailing backslash (unless the current directory is the root and a \ does not follow the $P macro). $T - The first or next tagged file name, with extension. When $T appears in a command line, Treeview executes the command once for each tagged file. $XC - The current file name, without its extension or trailing period. $XT - The first or next tagged file name, without its extension or trailing period. Like $T, $XT causes the command to be run once for each tagged file name. Macro examples: PRINT $C Runs the DOS PRINT command on the current file. If the file pointer was on the file TV.DOC, the command is executed as: PRINT TV.DOC The command COPY $T A: /V runs the COPY command once for each tagged file. If the files TV.CFG, TV.DOC, TV.EXE, and TV.HLP were tagged, the following commands are executed: COPY TV.CFG A: /V COPY TV.DOC A: /V COPY TV.EXE A: /V COPY TV.HLP A: /V When executing a DOS command in the Show-all or Show-sub modes (multiple directories displayed in a single file name window), use the $F or $P macros to ensure the command looks for the file in the proper directory. Without the $F or $P, the command will most likely assume the file is in the current directory, while it may in fact be in a different directory. The command FIND "silver" $T tries to find the string "silver" in all tagged files, but will not be able to search those files that are not in the current directory. The command FIND "silver" $P\$T searches all tagged files using the file's complete pathname (including files not in the current directory). To pass a macro name to DOS without being expanded, use two $'s. The command FLARP *.C $$P /DI is executed as: FLARP *.C $P /DI The macro names can be entered in upper or lower case, thus $C is the same as $c. Entering a $T or $XT macro on a command line causes Treeview to execute the command once for each tagged file in the current window. If you have a ram disk on your computer system, you can speed up such operations by putting a copy of the DOS COMMAND.COM file on the ram disk and pointing the COMSPEC environment variable to it. For example, if your system has a RAM disk as drive D: the following commands in the AUTOEXEC.BAT would copy the COMMAND.COM file and setup the COMSPEC environment variable: COPY C:\COMMAND.COM D: SET COMSPEC=D:\COMMAND.COM 6-3 Setting File Limits Treeview allows you to select the maximum number of files that can be displayed in a file name window. The number of files per window directly corresponds to the amount of your computer's memory required to hold file information. The smallest number allowed is 100, while the maximum is 2515. Approximately 64K of memory is used to hold file information when the maximum value of 2515 is selected. Having four maximum sized windows open at once would require 256K of memory, just to hold file information. If you want to minimize the amount of memory that Treeview itself uses, select a value for the number of files per window that is just large enough to hold all the files in one or your typical directories. Minimizing Treeview's memory usage allows more memory for any programs executed from within Treeview. The number of files per window is set with the [Other | Setup Parameters | # Files per Window] command. Changing this value does not effect any file name windows that are already open, only windows opened afterwards (via F7 or the [Window | Open] command), will have the new value. The number of files per window can be increased on a temporary basis by selecting the new value and then responding with an N to the "Write Changed Parameters to Disk (y/N):" prompt. Treeview's conventional memory requirement can be greatly reduced if your computer has LIM/EMS memory available to hold file information. See the topic USING LIM/EMS MEMORY for more information. 6-4 Point-and-Go Treeview's Point-and-Go facility provides the ability to operate on files with DOS commands or other programs simply by pointing at the file name and "executing" the file. Whenever Treeview executes a file, it looks at the file's extension to determine what processing is required. If the extension is .COM, .EXE, or .BAT, the file is treated as an executable program (.COM or .EXE) or as a batch file of DOS commands (.BAT). If the file has an extension other than .COM, .EXE, or .BAT, Treeview searches a table of file extensions and commands to determine how to process the file. Instead of executing the file itself, Treeview performs one or more DOS commands defined for files with matching extensions. The Point-and-Go commands are most useful when combined with Treeview's command line macros. These macros allow information such as the current drive, directory, and/or file name to be added to the command before it's executed. See Section 6-2 "DOS Command Macros" for a complete description of the available macros. As with User Defined Keys and the [Xecute] commands, you can specify multiple DOS commands to be executed in a Point-and-Go entry by separating the commands with '^' characters. The following example shows three DOS commands that could be given in a Point-and-Go entry. All three commands would be executed, in left to right order, when a file with a matching extension is "executed." del $xc.old^rename $xc.bak $xc.old^ws $c As an example of how to setup the Point-and-Go entries, consider an entry with an extension of .DOC and a command of WS $C. Whenever you enter Alt-X (short-cut for [Xecute | Current File]) with the file pointer over a .DOC file, Treeview executes the WS program with the current file name as a parameter. Alt-X with the file pointer on the file TV.DOC would execute the command WS TV.DOC while Alt-X on the file DC_TRIP.DOC would execute the command WS DC_TRIP.DOC The Point-and-Go table can hold up to 10 extension/command entries. You create and modify the entries with the [Other | Setup Parameters | Point and Go Setup] command. Each entry can specify from 1 to 3 different extensions. When entering multiple extensions, make sure to separate them with a single space. The following example shows how a couple of Point-and-Go entries might look: NUM EXT(s) COMMAND PROTOTYPE PAUSE READ 1 doc ws $c N N 2 c asm txt edlin $f N N 3 ltr del $xc.bak^ws $c N N 4 mdf automake $f N N Entry number 1 is the WS $C example presented above. Entry number 2 shows a command that edits files with three different extensions (.C, .ASM, and .TXT). Entry 3 shows two commands being executed for LTR files, while entry 4 edits AUTOMENU Menu Definition Files by running the AUTOMAKE program. For each Point-and-Go entry, you can define whether or not Treeview pauses and/or rereads the current directory after executing the DOS commands. If you enter "Y" (for YES) in a entry's PAUSE column, Treeview waits for you to press a key after running the command(s). An "N" (for NO) in the PAUSE column causes Treeview's screen to be redisplayed as soon as the commands finish. Entering "Y" for PAUSE allows you to view any output the commands leave on the screen before Treeview redisplays its own screen. Entering "Y" in the READ column of an entry tells Treeview to reread the current directory when the command(s) finish. A value of "N" will not reread the directory. "Y" should most likely be specified if the commands create or delete files, or if they change the current directory. Note that rereading the directory will result in "untagging" any files tagged before the commands were executed. 6-5 User Defined Keys Treeview provides the ability to execute user defined commands at the touch of a key. There are 30 User Defined Keys available. A particular User Defined Key is executed by pressing an Alt-Function key sequence, a Control-Function key sequence, or a Shift-Function key sequence; Alt-F1 executes User Defined Key number 1, Alt-F2 executes User Defined Key number 2, and so forth. User Defined Keys are created and modified with the [Other | Setup Parameters | User Defined Keys] command. The following sample entries show how User Defined Keys are entered. NUM KEY COMMAND PROTOTYPE PAUSE READ 1 A-F1 edlin $f N N 2 A-F2 pak v $f Y N 3 A-F3 chkdsk $d: Y N The first entry (invoked by the Alt-F1 sequence) runs the program EDLIN with the name of the current file as a parameter. Assuming EDLIN is a text editor, you could edit any text file by moving the file pointer to the file's name and pressing Alt-F1. The second entry shown above runs the program PAK with two parameters; the letter V and the name of the current file. PAK is a popular program for maintaining archived (compressed) files. Moving the file pointer to a .PAK file and pressing Alt-F2 would list the contents of the .PAK file. The third entry shown above runs the DOS CHKDSK command with the current drive letter as a parameter. As with Point-and-Go entries and the [Xecute] commands, you can specify multiple DOS commands to be executed by a User Defined Key. Each command must be separated from the others by the '^' character. The following example shows two DOS commands that could be executed by a User Defined Key: del $xc.bak^edlin $c For each User Defined Key, you can specify whether or not Treeview pauses and/or rereads the current directory after executing the commands. If you enter "Y" (for YES) in a command's PAUSE column, Treeview waits for you to press a key after running the command(s). An "N" (for NO) in the PAUSE column causes Treeview's screen to be redisplayed as soon as the commands finish. Entering "Y" for PAUSE allows you to view any output the commands leave on the screen before Treeview redisplays its own screen. Entering "Y" in the READ column of an entry tells Treeview to reread the current directory when the commands finish. A value of "N" will not reread the directory. "Y" should most likely be specified if the commands create or delete files, or if they change the current directory. Note however that rereading the directory will "un-tag" all files which were tagged before the commands were executed. 6-6 Using E.M.S. Memory Treeview can make use of two different types of memory in your computer system - conventional and expanded. Conventional memory is that part of memory used and controlled by DOS. There is normally somewhere between 128K and 640K of conventional memory available in an IBM PC or compatible system. The Lotus/Intel/Microsoft (LIM) Expanded Memory Specification (EMS) is a hardware and software system that provides extra (expanded) memory to programs that know how to use it. If your computer system has EMS compatible memory installed, Treeview can use this memory to store file names and other file data. Allowing Treeview to utilize EMS memory is advantageous because it leaves additional conventional memory available to execute DOS commands and other programs from Treeview. The [Other | Setup Parameters | Other Options | Use EMS (if available)] option enables or disables Treeview's use of LIM/EMS memory. If your computer system does not have LIM/EMS memory installed, this option has no effect as Treeview will then use conventional memory anyway. The [Other | Setup Parameters | Other Options | Use EMS (if available)] option is turned on when a check mark is displayed in front of the option - it's off when a not sign precedes the option. You can also enable or disable Treeview's use of EMS memory with the /C and /E command line parameters. Refer the topic COMMAND LINE PARAMETERS for more information. As distributed, the [Use EMS (if available)] option is on to allow Treeview's use of EMS memory - if EMS memory isn't available, conventional memory will be used anyway. 6-7 Video Snow Checking The [Other | Setup Parameters | Other Options | Video Snow Checking] option allows for faster screen updates on computer systems that do not make "snow" when writing directly to video memory. This option is only useful for some systems with color displays--monochrome displays do not make "snow" and Treeview knows not to check for snow when using a monochrome adapter. Disabling "snow" checking can significantly speed up screen updates. If you are not sure if your color display adapter makes snow or not, try disabling Treeview's snow checking. It will quickly be obvious if you need to re-enable the snow checking. Snow checking is enabled when a check mark is displayed before the [Other | Setup Parameters | Other Options | Video Snow Checking] option. Snow checking is disabled when a not sign is displayed. You can also enable or disable snow checking with the /F and /S command line parameters. Refer the topic COMMAND LINE PARAMETERS for more information. As distributed, video snow checking is disabled. 6-8 Defining the Editor and Viewer Treeview permits you to specify your own choice of file listing (viewing) utility as well as an editor. Even though a native file viewer is included, you might wish to use the famous LIST program written by Vern Buerg to view your files. To do this from the main Treeview screen you would press Alt-S (for Setup), "H" for External Program Hooks, and "V" to specify that you want to change the File Viewer. You will be asked for a "command prototype". This is the specification to tell Treeview what listing program to run and what form of filename to use with it in the form of a DOS macro). For example: LIST $F will instruct Treeview to use the List program and pass to it the current file (including pathname) and display it on the screen. More details on the concept of DOS macros are in Section 6-2. Available macros are listed in Appendix D. A user defined editor would be defined in exactly the same way, except you would specify "E" for File Editor and input the command prototype. 6-9 DOS Volume Labels You can change the name of the DOS volume label on your disk drive with this special capability of Treeview. From the main display screen, type "O" for Other and "L" for Set Volume Label. Input the new name and press RETURN. The new volume name will be displayed on the main screen. 6-10 DOS Verify Treeview can control the DOS verify function by turning it on or off. The Verify function performs a check every time a file is copied to make certain (verify) that the operation occurred successfully. Copying files will take a bit longer with verify turned on because of the checks that must be performed, however it is almost certain that many file related problems will not be noticed if the verify function is left on. If you use an exceptionally slow disk drive or CPU, you might be forced to leave verify off due to exceptionally long times required to do copy files. We recommend, however, that the DOS verify function be left ON at all times. Think of it as a little piece of insurance, a little peace of mind. SECTION 7 SHAREWARE CONSIDERATIONS Treeview is distributed under the shareware marketing concept, it is not free software and it has not been released to the public domain. The documentation, executable images, and all other files distributed with Treeview are copyrighted by Magee Enterprises. 7-1 What Is Shareware? Shareware is a way of distributing computer software that allows you to try out a program before you purchase it. Programs distributed as shareware typically give you some period of time to use the program and evaluate its usefulness to you. If the program doesn't meet your needs, you're under no obligation to pay for it. If you do find the program useful and wish to continue using it, the shareware program's author will request that you pay for the program by sending him or her a completed registration form and payment. If you find Treeview to be a useful addition to your software library, please become a registered user by completing the enclosed registration form and returning it along with the indicated license/registration fee. I hope that you will agree that the $39.95 fee is a small price to pay for the continued use of the program. It requires a large investment to develop, market, and support a product of this complexity. Your support in the form of a registration fee will help us to continue to make good software available at very reasonable prices. Treeview is also available at very special rates to organizations who wish to use it in promotional campaigns, or to educational institutions. Write to Magee Enterprises Inc. for information on using the program this way. 7-2 How To Register If you use Treeview on a regular basis, you should complete the registration form at the end of this document and return it along with the indicated license/registration fee. Registration gives you the right to use the software as documented in the license. There are two types of registrations available: 1) regular, and 2) quantity. Registration is required if Treeview is used in a business, government, or other commercial environment. The regular registration fee of $39.95 establishes you as a registered user of Treeview and upon receipt of your registration fee, you will be mailed a diskette containing the most recent Treeview version, a bound and printed manual, extended technical support and notice of product updates. Note that the version mailed to you may be the same version you already have, although updated versions will be released from time to time. Registered users will also receive the current release of TV286, a version of Treeview specifically made for computers with the Intel 80286 and 80386 microprocessors. APPENDIX A TREEVIEW MENU STRUCTURE Main Menu Line =============================================================== Dir Files Help Other Sort Tag/Untag Windows Xecute Quit =============================================================== DIR L Login New Directory Alt-L D Login New Drive Alt-G R Reread Current Dir Alt-N T Show Directory Tree Alt-T A Show All Dirs S Show Sub Dirs U Update Target Dir X Update Existing Files Only FILES A Set File Attributes C Current File Alt-A T Tagged Files Alt-B C Copy Files C Current File Alt-C T Tagged Files Alt-K R Use DOS Verify I Overwrite Check D Set File Date/Time C Current File T Tagged Files F Edit File Alt-F E Erase Files C Current Files Alt-E T Tagged Files Alt-Y I Extra File Info Alt-I R Rename/Move Files C Current File Alt-R T Tagged Files Alt-M V View File Alt-V X Execute File Alt-X HELP (See Appendix B) APPENDIX A TREEVIEW MENU STRUCTURE OTHER C Selection Criteria A Attribute R Reset to Defaults M File Name Mask C Clear Mask I Invert Mask I Treeview Information L Set Volume Label S Setup Parameters Alt-S C Screen Colors F # Files per Window P Point and Go Setup Alt-P U User Defined Keys Alt-U S Startup Defaults A Selection Attributes S Sort Options B Bypass Startup Screen Delay T Copy Options D Dir Tree Options H External Program Hooks E File Editor V File Viewer V View Options 7 Display 7 Bit Char M Require Case Match A Default to ASCII H Default to Hex O Other Options D Display as File Ext E Use EMS Memory F Sound Effects S Video Snow Checking 4 43 Line EGA Mode X Esc Exits at Top Level W Write Setup to Disk V Toggle DOS Verify SORT N Name E Extension D Date S Size U Unsorted A Ascending C Descending APPENDIX A TREEVIEW MENU STRUCTURE TAG/UNTAG C Current File D Date/Time I Invert M Modified N by Name T Today U Untag All S Select Tagged WINDOWS O Open F7 C Close F8 E Expand N Next F9 P Previous F10 XECUTE C Current File Alt-X D DOS Command Alt-D S DOS Shell QUIT Alt-Q APPENDIX B TREEVIEW HELP STRUCTURE HELP C Commands D Directories D Dir-Tree S Show All/Sub U Update F Files A Attributes C Copy D Date/Time I Info V View F Find X Execute O Other C Criteria S Setup C Colors D Defaults F Files G Go U User Defined Keys S Snow Checking O Options S Sort T Tag W Windows O Open/Close X Execute G Go M Macros I Input K Keyboard A Alt C Control F Function O Other Mouse M Menus P Parameters R Registration S Screen Q Quit APPENDIX C TREEVIEW KEYSTROKE COMMANDS Function Key Usage ================== F1 Help F2 Tag/Untag current file (toggle) F3 Login to parent directory F4 Login to subdirectory under pointer F5 Goto next tagged file (find NEXT in View) F6 Goto previous tagged file (find PREVIOUS in View) F7 Open another file display window F8 Close current file display window F9 Goto next filename display window F10 Goto previous filename display window Control key Usage ================= ^R PageUp ^C PageDown ^W, ^E Up Arrow ^Z, ^X Down Arrow ^A, ^S Left Arrow ^D, ^F Right Arrow ^G Delete ^V Insert ^H Backspace ^M Enter ^T Tag, Untag current file = Find File in current window + Tag Current File in Window - Untag Current File in Window APPENDIX D DOS COMMAND MACROS $C Filename with extension $D Drive letter, no trailing colon (:) $F Full pathname (drive, directory, filename and extension) $P Directory pathname, no trailing colon (:) $T First or next tagged filename (executes once per file) $XC Filename, no extension or trailing period $XT First or next tagged filename, no extension or trailing period (like $T, executes once per file) Examples of Command Prototypes with DOS Macros del $xc.old^ren $xc.bak $xc.old^ws $c pkarc a arcfile $t^copy arcfile a:\ /v^echo ALL DONE command [parameter(s)]^command [parameter(s)^command [parameter(s)] APPENDIX E CUSTOMER SUPPORT INFORMATION If you have problems with Treeview, please read this manual first to make sure you do understand everything. We have tried to provide a problem-free product but sometimes we make mistakes. If you think you have found a problem please take the time to contact us and explain your problem to us. All registered users will be informed of any problems and their solution. Make sure that you include the following information to help us evaluate the problem: 1. Version of DOS you are using 2. Machine type, memory, monitor type, hardware description 3. Any application executed before Treeview 4. Your address and telephone number (when corresponding) 5. Where, when and how you obtained Treeview 6. Which version of Treeview you are using 7. Printouts of your AUTOEXEC.BAT and CONFIG.SYS files 8. Your product SERIAL NUMBER We also provide an electronic Bulletin Board System (BBS) for anyone interested in Treeview or Shareware in general. This board currently supports 1200, 2400, 4800, and 9600 baud (Hayes) speeds and is available 24 hours a day, seven days a week. Multiple lines are now available, however in the future we will offer some lines that are limited to registered users only. We maintain the most current releases of our products and many other helpful files concerning Treeview, as well as a large selection of other SHAREWARE products provided to us DIRECTLY from the authors. The BBS can be reached by calling 404-446-6650. We also can be reached through a CompuServe ID: 76004,1541. Our Technical Support Group is open between the hours of 9am to 4pm ET Monday through Friday, and their direct line is 404-662-5387. We also a have FAX line available at 404-368-0719. Users will always receive a response to their questions. Non-registered users will receive a response if they enclose a self-addressed stamped enveloped with their query. If you write to us concerning a problem you've encountered using Treeview, please include as much of the following information about you computer system as you can. Thank you. Computer Make and Model _________________________________________ BIOS Type and Version Number ____________________________________ Display Adapter (CGA, EGA, VGA, etc.) ___________________________ Amount of conventional DOS memory installed _____________________ Amount of LIM/EMS memory installed ______________________________ Version of DOS in use (2.x, 3.x, 4.x) ___________________________ Device drivers being used _______________________________________ _________________________________________________________________ Any multi-tasking software in use (DESQview, Windows, etc.) _________________________________________________________________ What TSR programs are in use (Sidekick, Superkey, spoolers, etc.) _________________________________________________________________ Please describe the problem as fully as possible _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ Can you send copies of your CONFIG.SYS and AUTOEXEC.BAT files? __ _________________________________________________________________ Remember our FAX LINE (404) 368-0719 and the BBS (404) 446-6650 ------------------------------------ Treeview Registration Payment Form ------------------------------------ To order Treeview, please fill out the form below. Use your street address only, please. WE CANNOT SHIP TO A POST OFFICE BOX. Or call 1-800-662-4330 USA; or 404-446-6611 Date: _____________ Name: _____________________________ Title: ___________________ Company: ________________________________________________________ Address: ________________________________________________________ _________________________________________________________________ City: ___________________________________________________________ State/Country: ________________________ Zip: ____________________ Phone Work: (_____) _____ - ______ Home: (_____) _____ - ______ Method of payment: Please complete the worksheet below and choose one of the payment options indicated. Georgia State residents must add sales tax. ALL CHECKS AND MONEY ORDERS MUST BE DRAWN ON U.S. ACCOUNTS ONLY. +----------+------------------------------+----------+----------+ | | | Cost | Total | | Quantity | Description | per unit | Cost | +==========+==============================+==========+==========+ | | | | | | |Treeview 1.0 Software Package | $39.95 | | | | | | | +==========+=+============================+==========+==========+ | Georgia residents add sales tax | | +---------------------------------------+----------+ | Shipping Cost if Overseas, add $15.00 | | +---------------------------------------+==========+ TOTAL | | Please indicate diskette format: [ ] 5.25 +==========+ [ ] 3.5 [ ] Check with order [ ] Money Order [ ] MasterCard [ ] VISA Credit card #:______________________________ Exp. Date: ____/____ Signature: ______________________________________________________ Cardholder's name: ______________________________________________ Cardholder's address: ___________________________________________ (If different from above) ***************************************************************** Send all items to: Magee Enterprises, Inc. Treeview Order Department Post Office Box 1587 Norcross, Georgia 30091 USA --------------------- TREEVIEW COMMENT FORM --------------------- Your comments about this software and documentation are welcome. Please take the time to fill out this form or write or call us with your comments. Name: _____________________________ Title: __________________ Company: _______________________________________________________ Address: _______________________________________________________ ________________________________________________________________ City: __________________________________________________________ State/Country: ________________________ Zip: ___________________ Phone Work: (_____) _____ - ______ Home: (_____) _____ - ______ Treeview Version Number: ___1.0_______ Date: __________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ 21561.8811 ***************************************************************** Send this form to: Magee Enterprises, Inc. Treeview Comments Post Office Box 1587 Norcross, Georgia 30091 USA *****************************************************************